微信小程序蓝牙广播包解析指南：从入门到精通

大家好！今天我们来聊聊微信小程序中一个比较硬核但超级实用的功能——解析蓝牙广播包。如果你正在开发智能硬件相关的小程序，或者想通过蓝牙与设备通信，那这篇文章就是为你准备的！

1. 蓝牙广播包是什么？

蓝牙广播包（Advertising Data）是BLE（低功耗蓝牙）设备在广播状态下发出的数据包，里面包含了设备的名称、UUID、信号强度（RSSI）等信息。简单来说，就是设备在喊：“我在这里！这是我的信息！”

在微信小程序中，我们可以通过wx.onBluetoothDeviceFound监听这些广播包，但拿到的是原始数据，需要进一步解析才能读懂。

2. 如何在小程序中获取广播包？

首先，你需要在小程序的app.json里声明蓝牙权限：

{
  "permission": {
    "scope.bluetooth": {
      "desc": "用于蓝牙设备通信"
    }
  }
}

然后，调用微信的蓝牙API开始扫描设备：

wx.startBluetoothDevicesDiscovery({
  success(res) {
    wx.onBluetoothDeviceFound((result) => {
      console.log('发现设备:', result.devices);
    });
  }
});

这时候，result.devices会返回设备信息，其中advertisData就是广播包的原始数据（ArrayBuffer格式）。

3. 解析广播包的关键步骤

广播包的格式遵循BLE规范，通常由多个AD Structure组成，每个AD Structure包含：

• Length（1字节）：数据的长度
• Type（1字节）：数据类型（比如设备名称、厂商数据等）
• Data（实际数据）

示例代码：解析广播包

假设我们拿到一个advertisData，可以这样解析：

function parseAdvertisementData(buffer) {
  let offset = 0;
  const data = {};
  while (offset < buffer.byteLength) {
    const length = buffer[offset];
    if (length === 0) break;
    const type = buffer[offset + 1];
    const value = buffer.slice(offset + 2, offset + length + 1);
    
    switch (type) {
      case 0x09: // 设备名称
        data.name = String.fromCharCode.apply(null, new Uint8Array(value));
        break;
      case 0xFF: // 厂商自定义数据
        data.manufacturerData = value;
        break;
      // 其他类型可继续扩展...
    }
    offset += length + 1;
  }
  return data;
}

常见数据类型（Type）

• 0x01：Flags（广播模式）
• 0x09：设备名称
• 0x03：16位UUID
• 0xFF：厂商自定义数据（比如iBeacon）

4. 实战：解析iBeacon数据

iBeacon是苹果推出的一种蓝牙信标协议，它的数据通常放在0xFF（厂商数据）里，格式如下：

固定头（4字节） + UUID（16字节） + Major（2字节） + Minor（2字节） + 信号强度（1字节）

解析代码：

function parseIBeaconData(manufacturerData) {
  const view = new DataView(manufacturerData);
  if (view.getUint16(0) !== 0x004C || view.getUint8(2) !== 0x02) {
    return null; // 不是iBeacon
  }
  const uuid = Array.from(new Uint8Array(manufacturerData.slice(4, 20)))
    .map(b => b.toString(16).padStart(2, '0'))
    .join('');
  const major = view.getUint16(20);
  const minor = view.getUint16(22);
  const txPower = view.getInt8(24);
  return { uuid, major, minor, txPower };
}

5. 常见问题 & 优化建议

Q1：为什么收不到广播包？

• 检查设备是否在广播模式
• 确保小程序已授权蓝牙权限
• Android和iOS对广播包的处理可能不同，建议真机测试

Q2：广播包数据不完整？

• 部分设备会分多次发送广播包，可以尝试缓存数据
• 微信小程序对单次广播包大小有限制（通常31字节）

优化建议

• 使用ArrayBuffer和DataView处理二进制数据更高效
• 对频繁扫描的场景，适当增加扫描间隔（避免耗电）

6. 总结

解析蓝牙广播包是小程序蓝牙开发的核心技能之一，掌握了它，你就能轻松对接各种智能硬件设备！本文从基础概念到代码实现，希望能帮你少走弯路。如果有问题，欢迎在评论区交流~

下次我们聊聊如何通过小程序与蓝牙设备双向通信，记得关注哦！